home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / mods / chip / C64Show1.lha / c64musicshow / PlaySID.doc < prev    next >
Text File  |  1991-12-07  |  7KB  |  209 lines
  1.  
  2.     PLAYSID V2.0ß        (C)1990,91,92 Håkan Sundell & Ron Birk
  3.  
  4.     Releasedate: 7th December 1991
  5.  
  6.     Note:    This is SHAREWARE, not Public Domain. That means that
  7.     if you like this program and want further updates, you can
  8.     be a registrated owner if you send us a registration fee of
  9.     ~$15. It also means that you can spread this program only if
  10.     all files (including this) are included, and nothing is changed.
  11.     You are not allowed to replicate any portion of the program, both
  12.     code or data. Note also that we take no responsibilities for
  13.     the use of this program considering any damage to or failure of
  14.     your hardware, software etc.
  15.  
  16.  
  17. ABOUT:
  18.  
  19.     This is version 2.0 BETA. That mean that we haven't tested the
  20.     program on all kind of configurations and setups. If you come
  21.     over some problems or have any suggestions you will reach us
  22.     at the address further down.
  23.  
  24.  
  25. PRODUCT INFO:
  26.  
  27.     This is a utility which emulates the SID and 6510 chip. The
  28.     SID chip is the component in the C64 computer that handles sound.
  29.     The 6510 chip is the CPU of the C64, that means the component
  30.     that actually executes all programs. Because the Amiga does
  31.     not have these chips and others, you can't run C64 programs
  32.     directly on Amiga.
  33.  
  34.     Now this utility lets you play all those C64 programs that
  35.     produce sound. As you probably know, the C64 has three sound
  36.     channels (the amiga has four). But this utility also allows
  37.     use of the fourth channel. This channel is the product of
  38.     some special programming on the C64, it isn't really a channel.
  39.  
  40.     The purpose of this product is to make the best conversion
  41.     of C64 sound on Amiga ever possible. If you think some sound
  42.     isn't correctly converted please let us know.
  43.  
  44.     This utility is designed to work with true multitasking, under
  45.     any System version and any Amiga model. It can be run from both
  46.     Workbench and CLI/Shell. It should work with any other
  47.     program that don't use sound or timing. If this isn't the fact
  48.     please let us know.
  49.  
  50.     Some time ago we released a similar product called "The 100 most
  51.     remembered C64 game-tunes". This product is the version 2.0ß
  52.     of that program. The tunes on that demonstration disk are now
  53.     also available to this version. And up to date there are more
  54.     than 300 tunes available as PD. We and others are also working
  55.     with more.
  56.  
  57.  
  58. PROGRAM USAGE:
  59.  
  60.     To use this utility from Workbench you should assign SID: to a 
  61.     directory containing PlaySID. Then all you have to do is double-
  62.     click on the icon of the tune you want to play. Otherwise
  63.     you could just select the icon of the tune, then press the shift
  64.     key and hold it down while doubleclicking on the PlaySID icon.
  65.  
  66.     If you want to run this utility from CLI/Shell, just put the
  67.     directory containing PlaySID in your path (e.g. c: ) and then
  68.     write: PlaySID [<tune directory>/]<tune name>
  69.  
  70.     The "Setup" icon will copy the main program to RAM: and assign
  71.     it to SID:. After selecting this icon you only have to double-
  72.     click on the icon of the tune you want to play.
  73.  
  74.     This version require one argument. If not the program will tell
  75.     you so and exit. It works almost like an ordinary cassette
  76.     recorder, with the symbols for play, forward, stop and the
  77.     '-' symbol for filter. To quit press the stop symbol.
  78.  
  79.  
  80. TECHNICAL INFO:
  81.  
  82.     Up to date PlaySID features:
  83.  
  84.     * Full emulation of valid 6502 instructions.
  85.     * Full envelope emulation (even better than SID).
  86.     * Full waveform emulation (uses highest quality ever possible).
  87.     * Full ringmodulation/synchronize emulation (even both!).
  88.     * Emulation of the fourth channel, including Martin Galway NOISE
  89.       and all kind of SAMPLES.
  90.     * Sounding like C64 PAL even on Amiga NTSC (the right sound).
  91.     * Handle 50Hz, 60Hz and variable speed timing.
  92.     * Fast Forward
  93.     * Timer
  94.     * Amiga 4 kHz Filter ON/OFF (Should be off!).
  95.     * Full TRUE Multitasking (Opens, Closes and Checks everything).
  96.     * Real envelope display for all channels.
  97.  
  98.     PlaySID is written in C and Assembler. It uses about 50kB of
  99.     chip memory and 160kB of other memory. If playing samples, more
  100.     chip memory will be used. Also add the length of the tune to
  101.     the amount of other memory.
  102.  
  103.  
  104. TOOL TYPE INFO:
  105.  
  106.       Syntax of the Tool-Types of <tune>.info:
  107.  
  108.     ADDRESS = <loadaddress>,<initadress>,<playadress> ;in hex
  109.  
  110.       loadadress should be the C64 adress where the file should
  111.       be loaded.
  112.     
  113.       initaddress should point to a subroutine which initializes the
  114.       songnr in accumulator (starting with $00).
  115.  
  116.       playaddress should point to a subroutine which plays a note of
  117.       the song. This will be called as often as described in speed.
  118.  
  119.     SONGS = <nr of songs>,[<start song nr>] ;in dec
  120.  
  121.     SPEED = <speeddata> ;in hex
  122.  
  123.       speeddata contains info about playspeed. For each song a bit
  124.       is reserved, bit 0 for song nr 1 and so on. A 0 bit means 50 Hz
  125.       and a 1 bit means 60 Hz or the time set in $DC04/05.
  126.  
  127.     NAME = <name of tune> ;in ascii
  128.  
  129.     AUTHOR = <name of author> ;in ascii
  130.  
  131.     COPYRIGHT = <name of copyright owner> ;in ascii
  132.  
  133.  
  134. FUTURE FEATURES:
  135.  
  136.     In the next upgraded version these features will probably be
  137.     added:
  138.  
  139.     * Emulation of Filter.
  140.     * Faster emulation of 6502.
  141.     * Faster emulation of waveforms.
  142.     * Faster emulation of ringmodulation/synchronize.
  143.     * Emulation of nondefined 6502 instructions.
  144.     * Added selector of tunes (so you wont have to leave PlaySID
  145.       while selecting an other tune).
  146.     * Jukebox selector (so you can play several tunes after each
  147.       other).
  148.     * Option to Sound like C64 NTSC for American users who like NTSC.
  149.     * Option to load and show KOALA pictures.
  150.     * Option to load SID songs.
  151.     * The features YOU would like to be added (PLEASE WRITE AND TELL US).
  152.     * AND of course, MORE tunes
  153.  
  154.     If you convert by yourselve, PLEASE send them to us, using e-mail
  155.     or regular mail, so we can release complete packages. Then the
  156.     user will not get several packages with same or bad tunes.
  157.  
  158.  
  159. REGISTRATION:
  160.  
  161.     If you want to be a registered owner of this utility and
  162.     recieve further upgrades, then send ~$15 US (or equal amount in
  163.     DM, £ or SKR) with your name, address to either:
  164.  
  165.       Per Håkan Sundell
  166.       Luktärtsgatan 1 B
  167.     S-431 32 Mölndal
  168.       Sweden
  169.  
  170.     or
  171.  
  172.       Ron Birk
  173.       Krögarvägen 11
  174.     S-145 52 Norsborg
  175.       Sweden
  176.  
  177.  
  178.     If you want to phone us about complains or suggestions about
  179.     upgrades you can call:
  180.  
  181.     + 46 31 769424 (Håkan) about 6502 and SID emulation
  182.     + 46 753 88626 (Ron) about User interface
  183.  
  184.     If you have access to Internet you will reach us at the following
  185.     e-mail address:
  186.  
  187.     d89-rbi@nada.kth.se
  188.  
  189.  
  190.  
  191. NOTE TO OTHER DEVELOPERS:
  192.  
  193.     To Questronix (The makers of The A64 Package):
  194.  
  195.     We are still offering you our SID emulation to your
  196.     C64 Emulator (We have listened to your noise emulation).
  197.     And if that is interresting, we could help with the Cassette
  198.     interface too! (That will be connected as a diskdrive)
  199.  
  200.  
  201. LAST WORDS:
  202.  
  203.     We hope that you will find this program useful and that
  204.     it will bring back the old C64 athmosphere to you too...
  205.  
  206.  
  207.  
  208.  
  209.